Xfce Wiki

Sub domains
 

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
apps:orage:start [2022/02/22 16:06] – [The appointment window] erxusapps:orage:start [2023/07/02 08:04] (current) – Update Latest Release section kevinbowen
Line 1: Line 1:
 ~~NOTOC~~ ~~NOTOC~~
-{{ :xfce:xfce.gigolo.png?no link|}}+{{ :apps:orage:org.xfce.orage.png?no link|}}
 ====== Orage - A calendar application  ====== ====== Orage - A calendar application  ======
- 
-  * **[[#The preferences window|Preferences]]** 
-  * **[[#Dependencies|Dependencies]]** 
-  * **[[#Latest Release|Latest Release]]** 
-  * **[[#Source Code Repository|Source Code Repository]]** 
-  * **[[#Reporting Bugs|Reporting Bugs]]** 
- 
----- 
  
 Orage is a fast and easy to use graphical time-managing application for the Xfce Desktop Environment. It uses portable ical format and includes common calendar features like repeating appointments and multiple alarming possibilities. Orage does not have group calendar features, but can only be used for single user.  Orage is a fast and easy to use graphical time-managing application for the Xfce Desktop Environment. It uses portable ical format and includes common calendar features like repeating appointments and multiple alarming possibilities. Orage does not have group calendar features, but can only be used for single user. 
Line 17: Line 9:
 </figure> </figure>
  
 +  * **[[#Getting started|Getting started]]**
 +  * **[[#The calendar window|The calendar window]]**
 +  * **[[#The event list window|The event list window]]**
 +  * **[[#The day list window|The day list window]]**
 +  * **[[#The appointment window|The appointment window]]**
 +  * **[[#The exchange data window|The exchange data window]]**
 +  * **[[#The preferences window|The preferences window]]**
 +  * **[[#Integration with Xfce panel clock|Integration with Xfce panel clock]]**
 +  * **[[#Latest Release|Latest Release]]**
 +  * **[[#Source Code Repository|Source Code Repository]]**
 +  * **[[#Reporting Bugs|Reporting Bugs]]**
  
 ---- ----
Line 130: Line 133:
   * New: start an [[#The appointment window|appointment]] window for creating a new appointment for this day;   * New: start an [[#The appointment window|appointment]] window for creating a new appointment for this day;
   * Duplicate: also start an [[#The appointment window|appointment]] window for creating a new appointment for this day. But do not start from scratch, but copy all values from the active row in the appointment list below. Note that if you do not have any rows selected from the event list, this button does not do anything (but gives a warning);   * Duplicate: also start an [[#The appointment window|appointment]] window for creating a new appointment for this day. But do not start from scratch, but copy all values from the active row in the appointment list below. Note that if you do not have any rows selected from the event list, this button does not do anything (but gives a warning);
-  * Delete: remove all selected appointments. There is no undo, so be carefull with this button! Before removing anything Orage asks for your verification.+  * Delete: remove all selected appointments. There is no undo, so be carefull with this button! Before removing anything Orage asks for your verification;
   * Back: show previous day;   * Back: show previous day;
   * Today: show today;   * Today: show today;
Line 137: Line 140:
   * Find: activate the search tab;   * Find: activate the search tab;
   * Close: close this window;   * Close: close this window;
-  * Dayview: start day list window+  * Dayview: start day list window.
  
 === The tabs === === The tabs ===
Line 146: Line 149:
   * Todo: shows your active TODOs similarly than in the main calendar window. Only active ones are shown. If you want to see old TODOs, you need to find them in Search tab.   * Todo: shows your active TODOs similarly than in the main calendar window. Only active ones are shown. If you want to see old TODOs, you need to find them in Search tab.
   * Journal: lists your notebook entries starting from certain date. Default start date is one year back and you can not change the default setting.   * Journal: lists your notebook entries starting from certain date. Default start date is one year back and you can not change the default setting.
-  * Search: enter a free text, which is searched from all the appointments. Usually the search is case independent, but for some utf8 characters Orage switches to case sensitive search method. This happens if the length of the string is different in upper case compared to lower case (for example German language double //s// causes this). +  * Search: enter a free text, which is searched from all the appointments. Usually the search is case independent, but for some UTF-8 characters Orage switches to case sensitive search method. This happens if the length of the string is different in upper case compared to lower case (for example German language double //s// causes this). 
  
 === The appointment list === === The appointment list ===
Line 152: Line 155:
 The list shows all appointments satisfying the conditions and tab type. Scrollbars will appear if there are more lines or longer lines than what fits into the window. You can edit any appointment by double clicking the row. Each line has three fields: The list shows all appointments satisfying the conditions and tab type. Scrollbars will appear if there are more lines or longer lines than what fits into the window. You can edit any appointment by double clicking the row. Each line has three fields:
  
-  * Time: the starting and ending times of the appointment (the format varies depending on tab and appointment). All times are always shown in your local timezone. It is possible to define special whole day appointments and they have a text "All day" instead of real start and end times. Rows appear in start time order. +sign in front of the time means that the appointment started on some previous day and correspondingly +sign at the end of the time means that appointment continues and ends later than the selected day. If the Event tab shows today, there are few extra formattings used: When the event has passed, it is overstriked. Currently active events are shown with blue colour and future events are bold. +  * Time: the starting and ending times of the appointment (the format varies depending on tab and appointment). All times are always shown in your local timezone. It is possible to define special whole day appointments and they have a text "All day" instead of real start and end times. Rows appear in start time order. **+** sign in front of the time means that the appointment started on some previous day and correspondingly **+** sign at the end of the time means that appointment continues and ends later than the selected day. If the Event tab shows today, there are few extra formattings used: When the event has passed, it is overstriked. Currently active events are shown with blue colour and future events are bold. 
-  * Flags: gives information about the appointment. If your appointment has a category which has been associated with a clour, flags field has that colour background. (Note that the explanations are visible as a hint when you move your cursor into the appointment list.) There are five flags in order:+  * Flags: gives information about the appointment. If your appointment has a category which has been associated with a colour, flags field has that colour background. (Note that the explanations are visible as a hint when you move your cursor into the appointment list.) There are five flags in order:
      * Alarm: what kind of action happens when alarm time passes. **n** means no alarm has been defined. **A** means that visible window is raised. **S** means that sound is played. (If both visual and sound alarm is defined, S is shown)      * Alarm: what kind of action happens when alarm time passes. **n** means no alarm has been defined. **A** means that visible window is raised. **S** means that sound is played. (If both visual and sound alarm is defined, S is shown)
      * Recurrence: how often is that appointment happening. **n** means no repeating so that this event only happens once. **D** means daily repeat, **W** weekly, **M** monthly and **Y** yearly.      * Recurrence: how often is that appointment happening. **n** means no repeating so that this event only happens once. **D** means daily repeat, **W** weekly, **M** monthly and **Y** yearly.
Line 170: Line 173:
 </figure> </figure>
  
-The day list window shows all events that you have reserved for the next days. Default is to show 7 days, but you can change that and see up to 40 days at once. On top of the window you have menu and buttons to do actions. This is another form of your main activity window and more usefull than event list window if you want to find room for your new events or see your agenda and free time from longer perod than one day.+The day list window shows all events that you have reserved for the next days. Default is to show 7 days, but you can change that and see up to 40 days at once. On top of the window you have menu and buttons to do actions. This is another form of your main activity window and more usefull than event list window if you want to find room for your new events or see your agenda and free time from longer period than one day.
  
 === The button bar === === The button bar ===
Line 181: Line 184:
   * Forward: start listing one day later;   * Forward: start listing one day later;
   * Refresh: redisplay the window;   * Refresh: redisplay the window;
-  * Close: close this window+  * Close: close this window.
  
 === The parameters === === The parameters ===
Line 196: Line 199:
 ===== The appointment window ===== ===== The appointment window =====
  
-The appointment window is used to add, edit and delete appointments. It is the most complex window in Orage, but most fields still have good default values and are not mandatory. It has button bar (All actions are also available in menus above the buttons) and three tabs controlling basic settings and alarms and recurrence settings. +The appointment window is used to add, edit and delete appointments. It is the most complex window in Orage, but most fields still have good default values and are not mandatory. It has button bar (all actions are also available in menus above the buttons) and three tabs controlling basic settings and alarms and recurrence settings. 
  
 === The button bar === === The button bar ===
Line 205: Line 208:
   * Save and close: like Save, but also closes the window.   * Save and close: like Save, but also closes the window.
   * Revert: undo all changes done after previous save. Note that this button is active only after data has been changed.   * Revert: undo all changes done after previous save. Note that this button is active only after data has been changed.
-  * Duplicate: start creating new appointment and copy all values from the current activity into it. The new appointment is not created until you press //Save//+  * Duplicate: start creating new appointment and copy all values from the current activity into it. The new appointment is not created until you press Save. 
-  * Delete: remove current appointment permanently from orage system. +  * Delete: remove current appointment permanently from Orage system. 
  
 === The general tab === === The general tab ===
Line 213: Line 216:
 {{ :apps:orage:orage-appointment-window.png?direct&400 |}} {{ :apps:orage:orage-appointment-window.png?direct&400 |}}
 </figure> </figure>
 +
 +In this tab, you define the contents of the appointment.
 +
 +== Type ==
 +
 +Orage can handle three types of appointments:
 +
 +  * Event is something that happens sometimes. It has start and end time. This is the most common appointment type and you actually can handle all cases with this, since it also is the most flexible type. So if you are not sure what type to choose, Event is your best bet. Events either reserve your time (Availability=Busy) or are free which means this event does not take time from your schedule.
 +  * Todo is some action that you need to complete. It usually has a start time and due time when it has to be finished. It has no end time, which is replaced by the due time. You can also use duration similarly than with events. Todos have no availability, but instead they have completed time. After you set the completed time, the todo is done and is removed from lists visible in main calendar and in todo appointment tab.
 +  * Journals are just notes. They do not have end times nor availability. It is not possible to add alarm or recurrency for journals.
 +
 +== Title ==
 +
 +The title of the appointment. It appears in the event list and also in the alarm window and is listed at the header of this window. It should be a rather short summary of the appointment.
 +
 +== Location (Event and Todo) ==
 +
 +This field should describe where the event happens. It can be for example Home or Office or Paris depending on what kind of appointment you have. It is also possible to leave it empty. Orage is not using it in any special way, nor is it visible anywhere else than here. Journals do not have location.
 +
 +== All day event ==
 +
 +Selecting this checkbox causes so called whole day appointment to be defined. These do not have start nor end time defined, but it is possible that the event lasts several days. Start time is assumed to be the beginning of the day at 00:00 and end date at the last day at 24:00.
 +
 +== Start ==
 +
 +Defines the start time of the appointment. First, press the date button and choose the date from the calendar. After that you set the hour and minute using either your mouse wheel or clicking the small arrows. It is also possible to type the numbers directly to the fields. Hours go from 0 to 23 (24 is not allowed value).
 +
 +The last button is timezone. Default value for new appointments is your current timezone, which you have set in the preferences. It is recommended to use real timezones instead of floating. You should not mix floating with real timezones although it is possible. Floating means that time is not bound to any timezone, but varies according to current settings. Modifying either the default timezone or start timezone may cause floating values to change. 
 +
 +== End (Event) ==
 +
 +Similar to Start, but defines naturally the ending time. Note that start and end timezones may be different (for example when you schedule a meeting in abroad you can set the starting time in your local timezone and the rest of the timings in the destination timezone). [[#The event list window|Event list window]] always shows times in your local time. Only events have end time.
 +
 +== Due (Todo) ==
 +
 +Similar to End, but defines the time where the todo should be completed. Only todos have due time.
 +
 +== Duration (Event and Todo) ==
 +
 +Often it is easier to set the appointment duration instead of ending (or due) time. You can do that by marking the first box here. It is not possible to have both end/due time and duration at the same time, so end/due time setting will be unavailable after you select duration. Maximum duration is 1000 days, which is almost three years. Note that although the minute selection jumps 5 minutes at a time, you can manually enter any number.
 +
 +== Availability (Event) ==
 +
 +What kind of reservation is this. There are two possibilities: Free means that the action is not reserving the time and it is possible to schedule more appointments at the same time and respectively Busy means that nothing else can not be done at this time. Note that current version of Orage does not enforce these meanings and the flag is only as a comment (in the future this may be checked).
 +
 +== Completed (Todo) ==
 +
 +By selecting the Done box you mark this todo as done. The completed time can then be set. Format is similar to other times (like Start). Only todos have completed time.
 +
 +== Categories ==
 +
 +Free format text, which you can use to categorize your appointment. It is also possible to create a list of categories and associate those to colours. You can then pick one of those and get your appointment to be shown with that colour in the event list window.
 +
 +== Priority ==
 +
 +Priority of the appointment. Orage is not using this, so treat it just like a comment.
 +
 +
 +== Note ==
 +Free format text, where you can and should explain more the appointment. It is shown in the alarm window. Scrollbars appear when needed.
  
 === The alarm tab === === The alarm tab ===
Line 219: Line 282:
 {{ :apps:orage:orage-appointment-window-alarm.png?direct&400 |}} {{ :apps:orage:orage-appointment-window-alarm.png?direct&400 |}}
 </figure> </figure>
 +
 +In this tab, you define the alarm for the appointment. Orage supports three kinds of alarms: window, sound and procedure, but they all happen at the same time. It is possible to define only one alarm time for each appointment. To cause an alarm you need to do two things: You have to define alarm time and select alarm type. By default alarm happens 5 minutes before the appointment start time. Default alarm is Orage window without sound.
 +
 +Alarm time is set if any of the alarm timing numbers is non zero (in other words there is no special flag to set alarm; just define the time for it. This also prevents setting alarm to happen exactly at the appointment start/end time). You need explicitly select each alarm type by crossing the Use box. If you do not choose any alarm types, the alarm does not happen.
 +
 +== Alarm time ==
 +
 +Define how much earlier or later the alarm happens. If all numbers are zero, no alarm is raised for this appointment. The last field defines what these alarm offset numbers mean. You can define alarm to happen based on start or end time of the appointment and also if it happens after or before the time. Default is to alarm before the start time of the appointment. But specially for todos it is often more usefull to raise alarm before the due (=end) time. 
 +
 +== Persistent alarm ==
 +
 +When Orage is not running (for example if your computer is shutdown) alarms can't happen. If you want to get reminders after Orage starts again, you need to set the alarm as persistent. By default alarms are just lost.
 +
 +== Sound ==
 +
 +Define the sound file to be played when the alarm fires. Leaving this empty disables sound alarm. Remember to define the actual play command in the preferences dialog. You should also test that your system can play the filetype you choose there. Simply start a terminal and test it using the command you specified and the sound file.
 +
 +By default alarm sound is played only once, but you can make it repeated by choosing the box next line. You can also define how many time it is repeated and what is the interval. Be carefull to set the interval longer than the length of the sound since Orage does not wait for the previous sound to end before starting the next sound after the interval. Note that there is a silence button in visual alarms, so that you can stop the noise, but that only prevents the next play to happen, it does not interrupt currently playing alarm, which you should remember when using long lasting soundfiles.
 +
 +== Visual ==
 +
 +Orage can show two kinds of internal visual alarms. Orage window is a small alarm window showing the heading and note text. Notification is more fancy notification using libnotify. You need to have libnotify installed before you can define notification kind of visual alarm. ''orage -v'' shows if you have libnotify support included.
 +
 +== Procedure ==
 +
 +This makes it possible to use external alarms. You can run any operating system command or script. Common use for this is sending email. 
 +
 +== Execute ==
 +
 +You can test your alarm by pressing this. It raises the alarms immediately so that you can listen the sounds and see the windows.
 +
 +== Default alarm ==
 +
 +You can either set alarm back to default options or you can store current settings to be default alarm for all new appointments. There is only one default alarm, which applies to all appointments.
  
 === The recurrence tab === === The recurrence tab ===
Line 225: Line 322:
 {{ :apps:orage:orage-appointment-window-recurrence.png?direct&400 |}} {{ :apps:orage:orage-appointment-window-recurrence.png?direct&400 |}}
 </figure> </figure>
 +
 +In this tab you can define repeating appointments. Often it makes sense that the same appointment happens every day or every month instead of creating a new appointment for each event. Note that Orage does not support exclusion day ranges (like you would like to skip holiday period from you work related appointments), so you have to end the whole recurrency and enable it again after it need to resume. Orage also misses the possibility to modify only one specific event from a recurring set. All changes affect the whole set of appointments.
 +
 +== Complexity ==
 +
 +Default is Basic and that makes it possible to define frequency and limit of the appointment only. Often that is enough and these settings are very easy and fast to do even if you are not familiar with calendars and alarms. Selecting Advanced gives you more possibilities and makes it possible to build complex recurrent appointments like for example:
 +
 +  * Every Monday, Tuesday, Wednesday, Thursday and Friday.
 +  * Last Tuesday on every second month. 
 +
 +== Frequency ==
 +
 +This is the base repeating period. Default is no repeat (=None) and other possibilities are daily, weekly, monthly and yearly.
 +
 +The next selection makes it possible to easily skip some periods. Default value is 1 and it means every time as specified in the Frequency selection. 2 means every second time and 3 every third time etc. For example if you want to schedule your meeting to happen every third week, select Frequency = Weekly and set Interval to 3. (Starting time is selected in the [[#The general tab|General tab]] and next event happens exactly 3 weeks from that.)
 +
 +== Limit ==
 +
 +Orage allows you also to limit the repeating count:
 +
 +  * Repeat forever: this is default and does not limit the number of occurrences at all.
 +  * Repeat n times: the appointment is scheduled exactly n times. After that it ends (but is not removed).
 +  * Repeat until date: you can select the last date when this event happens. Note that it still happens normally during this date. 
 +
 +== Weekdays (Advanced) ==
 +
 +Default is that all days are checked, which means that the event happens normally every day. By removing any check, you prevent the appointment to happen on that day. In other words, your appointment only happens on checked weekdays. The most natural usage of this is to use it with Frequency = Daily. You may want to have a chat meeting for example each Monday and Wednesday. You can do this by selecting Frequency = Daily and by checking only Weekdays Mon and Wed.
 +
 +Selecting Weekly or Monthly actually causes the same thing. Deselecting any weekday for weekly or monthly or yearly repeating appointments causes all the remaining weekdays to become selected even though the original repeating selection only selects one day from the period. This is needed so that it is possible to schedule for example a meeting to happen every second week on Tuesday and Friday (Frequency = weekly, Interval = 2, Weekdays = Tue and Fri).
 +
 +== Which day (Advanced) ==
 +
 +This setting can only be used for monthly and yearly repeating events. It can be used to select which weekday from the month or year is selected. For example if you want to schedule your meeting to happen on the first Tuesday of every month, you can first select Frequency = Monthly and then check only Tuesday from Weekdays and finally set this "which day" number to be 1 (choose the number located below Tuesday). Negative numbers count backwards starting from the end of period and zero means that this setting is not used. Frequency = Yearly, weekdays = Thursday only clicked and which say = -2 means second last Thursday of the year. 
 +
 +== Exceptions ==
 +
 +Here is list of exception times. **-** sign at the end of the row means exclusion where the appointment does not happen even though it was included in the repeat set. **+** sign means it is extra time to do the appointment.
 +
 +You can remove the exception by double clicking it in the listing window. You can add new exception by first selecting the type (either excluded or included times) and then double clicking a day in one of the calendars below.
 +
 +(Note that even though excluded time should be date, it can be shown as time in some systems. This is a way to workaround a bug where some calendar backend systems are not able to handle full date exclusions properly.) 
 +
 +== Action dates ==
 +
 +Three small helper calendars, which show when the appointment will happen next. They show real time data, which is not stored in the system until you press save button. 
  
 [[|Back to Top]] [[|Back to Top]]
Line 230: Line 372:
  
 ===== The exchange data window ===== ===== The exchange data window =====
 +
 +The exchange data window is used to control physical files of Orage. It is possible to import files having calendar data or just use those files as they are (foreign). It is also possible to export appointments from Orage to operating system files and change the names of Orage data files.
  
 === The import export tab === === The import export tab ===
Line 237: Line 381:
 </figure> </figure>
  
-=== The orage files tab ===+== Import ==
  
-<figure "Orage exchange window - orage files tab">+Enter the name of the file which you want to copy into Orage. You can do several files in a row by separating names with comma. After you have the file name in place, press Save and Orage reads the contents in. After the file has been imported, those appointments are part of Orage and can't be differentiated or put back into the file. 
 + 
 +You can also import foreign files from the operating system using command line. This feature can be used to import ical files directly from the web by telling the browser (like Firefox) that the action is to start Orage. 
 + 
 +== Export == 
 + 
 +Enter the name of the file where you want Orage to write appointments. You can choose either all appointments or just a list of ids. Pressing save causes the appointments to be read and written to the external file. (The appointments are are not deleted from Orage but are kept in it also.) 
 + 
 +== Archive == 
 + 
 +You can either revert all archived appointments back to the main Orage file or force archiving. It is good idea to revert archive if you do exports since export does not look data from archive file. 
 + 
 +=== The Orage files tab === 
 + 
 +<figure "Orage exchange window - Orage files tab">
 {{ :apps:orage:orage-exchange-window-files.png?direct&400 |}} {{ :apps:orage:orage-exchange-window-files.png?direct&400 |}}
 </figure> </figure>
  
 +It is possible to relocate and rename both active Orage file and the passive archive file. Pressing save does the actual action. There are 3 options for these actions:
 +  * Rename: the safest choice. It only updates the file name in Orage internal structures. It does not touch operating system files at all. The new file has to exist before this operation can be done. First copy the file in you operating system and then you can change the name.
 +  * Copy: another safe choice. File is copied first into the new place followed by the internal rename described above.
 +  * Move: File is moved first into the new place followed by the internal rename described above. Note that the original file does not exist in the original place anymore after this change.
 +        
 === The foreign files tab === === The foreign files tab ===
  
Line 248: Line 411:
 {{ :apps:orage:orage-exchange-window-foreign.png?direct&400 |}} {{ :apps:orage:orage-exchange-window-foreign.png?direct&400 |}}
 </figure> </figure>
 +
 +Orage can include and maintain other than its main data file. It is possible to add (and remove) so called foreign files. They behave similarly than base data file, but they remain isolated, so that it is easy to move them back to the original system where they came from. This is mainly meant to be used when you need to maintain your calendar also in other than Orage. Sometimes it is good idea to mark the file as read only, which prevents you from modifying any of the appointments in the corresponding file. (Orage uses some private ical components, which are not necessarily understood by the other system, so updates may cause problems for the other tool.)
 +
 +You can also add foreign files from the operating system using command line: ''orage --add-foreign file''
 +
  
 [[|Back to Top]] [[|Back to Top]]
Line 261: Line 429:
 </figure> </figure>
  
-**Timezone**+== Timezone ==
  
 You should always set the default timezone for Orage. It is possible to use also floating times, but then all times should be in floating form. It is a bad idea to mix floating and timezone times. Floating times tend to move to follow any timezones they see...  You should always set the default timezone for Orage. It is possible to use also floating times, but then all times should be in floating form. It is a bad idea to mix floating and timezone times. Floating times tend to move to follow any timezones they see... 
  
-**Archive threshold**+== Archive threshold ==
  
 Orage does not delete appointments automatically, so usually your calendar file grows bigger and because of that Orage gets slower and takes up more memory from the system. Enabling automatic archiving causes old appointments to be moved from the active calendar file to passive history file after the selected time. This helps to keep the active file smaller and the application in good shape. Archiving is enabled by setting the threshold to other than 0 value. Of course it is also possible to manually delete appointments, but that removes them permanently and you will not be able to find them later. Orage does not delete appointments automatically, so usually your calendar file grows bigger and because of that Orage gets slower and takes up more memory from the system. Enabling automatic archiving causes old appointments to be moved from the active calendar file to passive history file after the selected time. This helps to keep the active file smaller and the application in good shape. Archiving is enabled by setting the threshold to other than 0 value. Of course it is also possible to manually delete appointments, but that removes them permanently and you will not be able to find them later.
Line 271: Line 439:
 Note that Orage also splits [[#The recurrence tab|recurring appointments]] so that if the original start date is older than threshold, that appointment is added to the archive file and the starting date in the active calendar file is updated to contain only values more recent than the threshold. This also saves time when Orage is searching recurrent events. Note that Orage also splits [[#The recurrence tab|recurring appointments]] so that if the original start date is older than threshold, that appointment is added to the archive file and the starting date in the active calendar file is updated to contain only values more recent than the threshold. This also saves time when Orage is searching recurrent events.
  
-**Sound command**+== Sound command ==
  
 Here you can define which sound command Orage uses when playing sound files. Try testing some common commands like ''play'' or ''aplay'' from terminal to see what works on your system. You probably do not want to use full version of Totem or MPlayer since they will cause a video window also to appear and that most probably is not what you want. Here you can define which sound command Orage uses when playing sound files. Try testing some common commands like ''play'' or ''aplay'' from terminal to see what works on your system. You probably do not want to use full version of Totem or MPlayer since they will cause a video window also to appear and that most probably is not what you want.
Line 285: Line 453:
 In this tab you can define visibility options for the [[#The calendar window|main window]] of Orage.  In this tab you can define visibility options for the [[#The calendar window|main window]] of Orage. 
  
-**Show borders**+== Show borders ==
  
 You can hide window borders and make the calendar window smaller by unselecting this option. This frees more space to your other applications from your workspace. You can hide window borders and make the calendar window smaller by unselecting this option. This frees more space to your other applications from your workspace.
  
-**Show day names**+== Show day names ==
  
 Controls day names visibility on top of the calendar window. Controls day names visibility on top of the calendar window.
  
-**Show month and year**+== Show month and year ==
  
 Select whether you want to see month and year controls in the main calendar window. Select whether you want to see month and year controls in the main calendar window.
  
-**Show menu**+== Show menu ==
  
 By unselecting this you can leave out the menubar in the top of the calendar window. By unselecting this you can leave out the menubar in the top of the calendar window.
  
-**Show week numbers**+== Show week numbers ==
  
 Controls visibility of week numbers on left of calendar. Controls visibility of week numbers on left of calendar.
  
-**Show todo list**+== Show todo list ==
  
 You can hide TODO list in the main calendar by deselecting this.  You can hide TODO list in the main calendar by deselecting this. 
  
-**Number of days to show in event window**+== Number of days to show in event window ==
  
 You can hide EVENT list in the main calendar by setting this to zero. Non zero values means the number of days to show events for. You can hide EVENT list in the main calendar by setting this to zero. Non zero values means the number of days to show events for.
  
-**Show on all desktops**+== Show on all desktops ==
  
 Show calendar window on all workspaces by selecting this. Show calendar window on all workspaces by selecting this.
  
-**Keep on top**+== Keep on top ==
  
 Keep calendar window on top of all other windows.  Keep calendar window on top of all other windows. 
  
-**Show in taskbar**+== Show in taskbar ==
  
 Controls if calendar is visible in the taskbar.  Controls if calendar is visible in the taskbar. 
  
-**Show in pager**+== Show in pager ==
  
 Controls if calendar is visible in the pager. Controls if calendar is visible in the pager.
  
-**Show in systray**+== Show in systray ==
  
 Controls if calendar is visible in the systray. A small icon is presented in the systray if this is selected. It is recommended that you enable this feature. By clicking this icon Orage is toggled visible or hidden. If you do not have Orage in the systray, you can make the main calendar window visible again by start Orage again. Controls if calendar is visible in the systray. A small icon is presented in the systray if this is selected. It is recommended that you enable this feature. By clicking this icon Orage is toggled visible or hidden. If you do not have Orage in the systray, you can make the main calendar window visible again by start Orage again.
  
-**Calendar start**+== Calendar start ==
  
 It is possible to define that Orage starts in the background or as minimized. This option only affects the start of Orage. It is possible to define that Orage starts in the background or as minimized. This option only affects the start of Orage.
  
-**On calendar window open**+== On calendar window open ==
  
 If calendar is opened then set selected day to today's date or last selected date. If calendar is opened then set selected day to today's date or last selected date.
  
-**Calendar day double click shows**+== Calendar day double click shows ==
  
 On double click open days view window or event list. On double click open days view window or event list.
Line 350: Line 518:
 </figure> </figure>
  
-**Event list window**+== Event list window ==
  
 Define how many days to show in the event list when it starts. (It is possible to change the number in the event list window.)  Define how many days to show in the event list when it starts. (It is possible to change the number in the event list window.) 
  
-**Day view window default first day**+== Day view window default first day ==
  
 Set day view window first day either first day of week or selected day. Set day view window first day either first day of week or selected day.
  
-**Use wakeup timer**+== Use wakeup timer ==
  
 Use this timer if Orage has problems waking up properly after suspend or hibernate. For example tray icon not refreshed or alarms not firing. Use this timer if Orage has problems waking up properly after suspend or hibernate. For example tray icon not refreshed or alarms not firing.
  
-**Always quit when asked to close**+== Always quit when asked to close ==
  
 By default Orage stays open in the background when asked to close. This option changes Orage to quit and never stay in background when it is asked to close. By default Orage stays open in the background when asked to close. This option changes Orage to quit and never stay in background when it is asked to close.
Line 369: Line 537:
 ---- ----
  
-===== Dependencies =====+===== Integration with Xfce panel clock =====
  
-For compiling Orage, you will need the GTK (>= 3.24.0) libraries and header files. You will also need its dependency libraries and header filessuch as Pango, Cairo and Glib.+Orage can be opened by double mouse click to panel clockSince from Xfce 4.18panel clock properties can be used to enter orage command:
  
-Furthermore you need, of course, a C compiler.+<figure "Calendar plugin preferences window with orage command"> 
 +{{ :apps:orage:xfce4-clock-plugin-preferences.png?direct&300 |}} 
 +</figure>
  
-Required dependecies: +Before Xfce 4.18, can be usued following one-liner to create the configuration that calls orage: 
-  * Xfce development tools 4.16.0 or newer +<code> 
-  * GTK 3.24.0 or newer +COMMAND="orage -t"; xfconf-query -c xfce4-panel -p $(xfconf-query -c xfce4-panel -lv | grep clock | awk '{print $1}')/command -t string -s "$COMMAND" -n</code>
-  * GLib 2.52.0 or newer +
-  * intltool 0.35 or newer+
  
-Optional dependencies: +More information about Xfce panel clock hidden settings can be found [[https://docs.xfce.org/xfce/xfce4-panel/clock#hidden_settings|xfce4-panel - Clock documentation page]]
-  * Libical 3.0 or newer +
-  * D-Bus 0.1 or newer +
-  * Libnotify 0.3.2 or newer+
  
 [[|Back to Top]] [[|Back to Top]]
Line 390: Line 555:
  
 ===== Latest Release ===== ===== Latest Release =====
-{{rss>https://archive.xfce.org/feeds/project/orage 1 date description 2h}}+{{rss>https://archive.xfce.org/feeds/project/orage 1 date 2h}} 
 + 
 +[[https://gitlab.xfce.org/apps/orage/-/blob/master/NEWS|Read the CHANGELOG]]
  
-  * **[[http://archive.xfce.org/src/apps/orage/|Previous Releases]]**+  * **[[https://archive.xfce.org/src/apps/orage/|Download current release]]** (link also contains older versions)
  
 [[|Back to Top]] [[|Back to Top]]